home *** CD-ROM | disk | FTP | other *** search
/ Programming Languages Suite / ProgramD2.iso / Visual Database / Visual dBase Pro v7.0 / README.TXT < prev    next >
Text File  |  1997-11-20  |  13KB  |  315 lines
  1. ------------------------------------------------------------
  2. Visual dBASE 7
  3. README.TXT
  4. Updated 11/20/97 5:52 PM
  5.  
  6. Welcome to Visual dBASE 7! This next generation in dBASE
  7. development includes many new productivity-enhancing
  8. features, including:
  9.  
  10. * Native 32-bit development
  11. * 32-bit Visual dBASE Compiler
  12. * Integrated native Visual dBASE Report Writer
  13. * Visual Project Explorer
  14. * Enhanced Visual Designers
  15. * Live Two-Way Tools
  16. * Powerful Source editor with TreeView control
  17. * Programmable Grid control
  18. * ActiveX integration
  19. * Rich set of new Database components
  20. * New DBF 7 Format
  21. * Automatic field lookup and fill-in
  22. * SQL Designer
  23. * New language elements
  24.  
  25. Be sure to check the Contents page of the online Help for
  26. more information on these and other new features, a list of
  27. changes from previous versions, and information on
  28. documentation updates, white papers, and other technical
  29. information.
  30.  
  31. ------------------------------------------------------------
  32. CONTENTS
  33. ------------------------------------------------------------
  34.  
  35. 1. GENERAL USAGE NOTES
  36. 2. BDE NOTES AND ISSUES
  37. 3. NOTES FOR USERS OF EARLIER VERSIONS
  38. 4. Visual dBASE RESOURCES
  39. 5. UNINSTALLING THE PROGRAM
  40.  
  41. ------------------------------------------------------------
  42. 1. GENERAL USAGE NOTES
  43. ------------------------------------------------------------
  44.  
  45. * For a guide to the sample code and utilities, run the
  46.   "Sample Guide.wfm" form in the \Samples directory.
  47.  
  48. * When creating a PRIMARY or DISTINCT index on a DBF or DB
  49.   table, records with duplicate key values are copied to a
  50.   KEYV??? table and deleted from the original table.
  51.  
  52. * The interactive BROWSE command has no options (contrary to
  53.   the documentation -- the listed options are ignored). The
  54.   Browse class does not support the text property as
  55.   documented in the Help; all other Help-documented
  56.   properties are supported. All other version 5.x
  57.   properties are ignored, and are listed in the Obsolete
  58.   category of the Inspector.
  59.  
  60. * In the fields property of the Browse control, the Read-
  61.   only, Range, When, Valid, and Error message options do
  62.   not work.
  63.  
  64. * Automatic field lookup and fill-in is provided by the
  65.   lookupSQL and lookupRowset properties of the Field
  66.   object. If these properties are defined as custom field
  67.   properties in a DBF7 table, the Form wizard will create
  68.   comboboxes for those fields, which will automatically
  69.   contain the lookup values.
  70.  
  71. * Do not enclose DBCS (Double Byte Character Set) alias
  72.   names in quote marks in SQL statements.
  73.  
  74. * The Remote Data Entry and Query And Response Web Wizards
  75.   currently work with O'Reilly's WebSite 2.0 only. Visit
  76.   the Visual dBASE home site (see below for URL) for
  77.   information on using other web servers.
  78.  
  79. ------------------------------------------------------------
  80. 2. BDE NOTES AND ISSUES
  81. ------------------------------------------------------------
  82.  
  83. * The DBASE driver now defaults to Level 7. Tables that are
  84.   created from scratch (e.g. with CREATE or CREATE TABLE,
  85.   as opposed to being copied from existing tables) will be
  86.   DBF7 tables.
  87.  
  88.   To change the Level setting, close Visual dBASE (as well
  89.   as any other programs that may be using the Borland
  90.   Database Engine) and use the BDE Administrator utility
  91.   (BDEADMIN.EXE). Change the Level setting in
  92.   [\Configuration\Drivers\Native\DBASE] to the desired
  93.   level. Then restart Visual dBASE.
  94.  
  95. * When sharing .DBF tables with a non-BDE application (e.g.
  96.   Clipper, FoxPro), set the BDE Local Share
  97.   [\Configuration\System\INIT] setting to true to ensure
  98.   that record locks are respected between that application
  99.   and Visual dBASE. The same applies when sharing with a
  100.   BDE16 application like Visual dBASE 5.x; in addition, the
  101.   BDE16 configuation must also have its Local Share (in the
  102.   System tab of the BDE Configuation Utility) set to true.
  103.  
  104. * To create FoxPro tables, create a BDE database alias using
  105.   the new FoxPro driver in the BDE Administrator and use
  106.   that alias as the active database. (Do not use the DBASE
  107.   driver at Level 25, as with earlier versions of BDE.) You
  108.   do not have to create an alias to use existing FoxPro
  109.   tables; the BDE automatically distinguishes between dBASE
  110.   and FoxPro DBFs.
  111.  
  112. * Connecting to a database twice with ODBC 3.4: Due to a
  113.   known bug in Microsoft's ODBC 3.4, connecting to a
  114.   database twice with this driver can cause Visual dBASE to
  115.   shut down. This problem is fixed in ODBC 3.5.
  116.  
  117. * In Local SQL, when querying logical fields do not use
  118.   single or double quotes around the boolean literal in the
  119.   criteria. For example, the following SQL statement is the
  120.   correct syntax:
  121.  
  122.     SELECT some_field FROM table WHERE boolean_field = true
  123.  
  124. * When using the AS clause to rename a field, the field name
  125.   cannot exceed 31 characters, including the table or alias
  126.   name if used (the dot between the table and field names
  127.   and quote marks around the names are not counted). For
  128.   example, the field name in the following SQL statement is
  129.   31 characters, the maximum allowed length:
  130.  
  131.     SELECT fd AS t23."f567890123456789 12345678901" FROM t23
  132.  
  133.   Note that the SQL designer omits the optional AS keyword.
  134.   It would generate an SQL statement that looks like:
  135.  
  136.     SELECT fd t23."f567890123456789 12345678901" FROM t23
  137.  
  138. * Perform a parameterized SQL operation on a BLOB field only
  139.   if the value of the parameter is less than 256 bytes.
  140.  
  141. * If you install the trial version of IntraBuilder or
  142.   C++Builder (or any other Borland product) after
  143.   installing Visual dBASE 7, you may overwrite the new
  144.   version of BDE with an older version. To prevent this,
  145.   deselect the BDE when installing the older software, or
  146.   reinstall the BDE from Visual dBASE 7 using the Custom
  147.   install option.
  148.  
  149. MS Access support:
  150.  
  151. * To enable Access support, the Microsoft DAO/Jet engine
  152.   must already be installed on the target machine. This
  153.   component is provided by Microsoft Access/Office and some
  154.   Microsoft development tools; it is not provided by Visual
  155.   dBASE.
  156.  
  157. * Some functionality is not yet implemented in the Access
  158.   driver in this release. BCD (binary coded decimal)
  159.   support is not available. Key-violation tables cannot be
  160.   created when creating an index. Heterogeneous queries and
  161.   queries using the local SQL engine are not supported. In
  162.   addition, you cannot MODIFY STRUCTURE or REINDEX.
  163.  
  164. * MS Access does not support opening a table that has
  165.   already been opened exclusively. Hence opening a table
  166.   exclusively prevents the user from opening that table
  167.   again, even in same session.
  168.  
  169. DBF Referential Integrity (RI):
  170.  
  171. * With multiple RI tiers (e.g. parent is linked to middle,
  172.   middle is linked to child), the RI links must be created
  173.   from the parent toward the child. That is, the
  174.   parent->middle link must be made before the middle->child
  175.   link. Modifications must be made in this order as well,
  176.   otherwise the links may become out-of-sync internally. If
  177.   it is suspected that the RI links have become out-of-
  178.   sync, go into the RI dialog and "Modify"/"OK" each RI
  179.   link starting from the parent link to the child link.
  180.  
  181. * When restructuring tables with referential integrity links
  182.   (including deleting or modifying indexes), be sure to
  183.   drop the RI links before making modifications to the
  184.   tables. Otherwise, the RI links may become out-of-sync
  185.   internally. If it is suspected that the links have become
  186.   out-of-sync, please follow the step described in the
  187.   previous paragraph.
  188.  
  189. * Cascaded deletes are not allowed for multi-tier (more than
  190.   parent and child) RI links. The user will receive the
  191.   error message, "Database Engine Error: Conflicting record
  192.   lock in this session".
  193.  
  194. * Circular RI links are not supported (e.g. master->detail,
  195.   detail->master) for this version.
  196.  
  197. ------------------------------------------------------------
  198. 3. NOTES FOR USERS OF EARLIER VERSIONS
  199. ------------------------------------------------------------
  200.  
  201. For an overview of new features and functionality, as well
  202. as a review of what's changed in Visual dBASE, see VDB.HLP
  203. in the \Help directory (or choose Visual dBASE Help from the
  204. Start menu)
  205.  
  206. In addition, please note the following:
  207.  
  208. * Visual dBASE will automatically upgrade a .DBF table to
  209.   the new DBF7 format if you restructure or modify the
  210.   schema of the table in any way, including with the
  211.   CONVERT command. (Simply modifying the records of the
  212.   table does not automatically change the format.)
  213.   Attempting to USE a DBF7 table in an earlier version of
  214.   dBASE will cause an error. To prevent this, change the
  215.   DBASE driver Level setting, as detailed in BDE Notes
  216.   above, before restructuring the table.
  217.  
  218. * It is no longer necessary to USE a table EXCLUSIVE to
  219.   MODIFY STRUCTURE. MODIFY STRUCTURE always attempts to
  220.   reopen the table in exclusive mode.
  221.  
  222. * Although .QBEs are still functional, .DMDs (data modules)
  223.   are now recommended for defining an updateable set of
  224.   tables (both linked and unlinked). A .QBE to .DMD
  225.   converter (QBE2DMD.PRG) is available in the
  226.   \Utilities\Upgrade directory. This converter can also be
  227.   run from the Sample Guide form.
  228.  
  229. * Changes in the default design font (from MS Sans Serif 8
  230.   to Arial 10) may affect forms you created using earlier
  231.   versions of Visual dBASE.
  232.  
  233. * Forms and menus are now streamed using the new WITH syntax
  234.   instead of the old DEFINE syntax. If you want to run the
  235.   same form/menu in an earlier version of Visual dBASE,
  236.   keep a separate copy.
  237.  
  238. * The REPORT FORM and LABEL FORM commands are not functional
  239.   in this release. To run a new native report or label, DO
  240.   the .REP or .LAB file (just like a form).
  241.  
  242. * With the exception of COLUMNAR, the EDIT command has no
  243.   options.
  244.  
  245. * The BUTTONS.CC custom control library is not included with
  246.   this product. The library from earlier versions will not
  247.   work in Visual dBASE 7 without adjustments to the
  248.   library's ReportButton and ToolButton classes. Because
  249.   there is now a built-in ToolButton class (used in
  250.   toolbars), you must rename the ToolButton class in
  251.   BUTTONS.CC, and all instances of that class in your
  252.   existing code.
  253.  
  254. * The include files UTIL.H, ENUM.H, and MESSDLG.H have been
  255.   replaced by the file VDBASE.H in the \Include
  256.   subdirectory. Change any #include statements that
  257.   reference those old files to the new file, or copy the
  258.   old files from an earlier version of Visual dBASE into
  259.   the new \Include subdirectory.
  260.  
  261. ------------------------------------------------------------
  262. 4. Visual dBASE RESOURCES
  263. ------------------------------------------------------------
  264.  
  265. The Visual dBASE home site on the World Wide Web, at
  266. http://www.borland.com/VdBASE (all URLs are case-sensitive),
  267. helps you find the most current information about Visual
  268. dBASE. Periodic upates to the Visual dBASE Help system, as
  269. well as technical notes, tips, and other materials that will
  270. further your understanding of the program, can be found
  271. through the Product Library and Developer Support links.
  272.  
  273. Borland offers a number of newsgroups for obtaining and
  274. exchanging information on Visual dBASE and other Borland
  275. products. To access the newsgroups, set your news reader to
  276. point to the server forums.borland.com, or visit
  277. http://www.borland.com/newsgroups/
  278.  
  279. You can also subscribe to the dNEWS newsletter for the
  280. latest information on Visual dBASE 7 by filling in a form on
  281. our Web site and selecting 'Visual dBASE'. The form is
  282. available on Borland Online at:
  283. http://www.borland.com/feedback/listserv.html
  284.  
  285. ------------------------------------------------------------
  286. 5. UNINSTALLING THE PROGRAM
  287. ------------------------------------------------------------
  288.  
  289. * Windows 95 or Windows NT 4.0: Use the Add/Remove Programs
  290.   applet in the Control Panel.
  291.  
  292. * Be sure to close the Control Panel before starting the
  293.   uninstall process. Otherwise, the BDE Administrator,
  294.   which is in the Control Panel, will not be removed,
  295.   preventing the uninstall from removing all components.
  296.  
  297.  
  298. ------------------------------------------------------------
  299. Copyright ⌐ 1997 Borland International, Inc.
  300. All rights reserved. All Borland products are trademarks or
  301. registered trademarks of Borland International, Inc. Other
  302. brand and product names used in this document and other
  303. documents and files included in this software package are
  304. trademarks or registered trademarks of their respective
  305. holders.
  306.  
  307. This software is based in part on the work of the
  308. Independent JPEG Group (IJG).
  309.  
  310. The Graphics Interchange Format(c) is the Copyright property
  311. of CompuServe Incorporated. GIF(sm) is a Service Mark
  312. property of CompuServe Incorporated.
  313.  
  314.  
  315.